home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / mac / sparkle / spark202.hqx / Docs / README 0th --- CD ROM Users < prev    next >
Encoding:
Text File  |  1994-05-17  |  4.7 KB  |  92 lines
  1. Sparkle is a free program for the Macintosh that can encode or play MPEG files and 
  2. convert them to QuickTime movies. It requires a Mac with a 68020 or higher 
  3. processor, QuickTime 1.6 or higher and System 7 or higher. It runs much 
  4. better with the Thread Manager installed. If you don't have the Thread 
  5. Manager you can obtain it from 
  6. ftp.apple.com  in dts/mac/sys.soft/thread-manager-2-0-1.hqx.
  7. (Note that this supercedes the ftp address given in the program itself, 
  8. because Apple recently re-arranged their ftp site.)
  9. Sparkle runs on PowerPCs but is not yet native so performance will be 
  10. disappointing.
  11. Note that at present Sparkle can only understand the video stream of an 
  12. MPEG file, not the full ISO 11172 stream. However Sparkle understands I P 
  13. and B frames and can usually cope with anomalies in the file structure 
  14. like a file that begins with a set of B frames.
  15. At present most MPEG files consist of only the video stream, so lack OF 
  16. ISO 11172 isn't a real problem yet, but I'll be adding said support ASAP.
  17.  
  18. The version of Sparkle on this CD ROM is 2.02.
  19.  
  20. Sparkle 2.02 is optimized for playback on 24 bit screens. Playback on 16 
  21. bit screens will be slower and playback on 8 bit screens will be painfully 
  22. slow (though at very high quality dithering). 
  23.  
  24. This program was written for distribution over the Internet and I fear 
  25. that CD ROM users may be misled by it in the absence of a few notes.
  26.  
  27. * This program is in a constant state of flux. Sometimes I release new 
  28. versions because I'm satisfied with attaining a certain level of 
  29. functionality. At other times I release very rough code because there is a 
  30. large demand for the code, albeit rough. In particular the MPEG encoding 
  31. of Sparkle is very slow, uses way more memory than necessary, and may 
  32. encode misleading or incorrect values for some parts of the MPEG stream.
  33. The next release of Sparkle, 2.1, in June 94 or so speeds up MPEG 
  34. playback by 150% to 300% (with special case support for common screen 
  35. depths other than 24 bit), provides real time playback (skipping frames if 
  36. necessary)  and provides substantial additions to the user interface. 
  37. After this I will improve MPEG encoding and add support for ISO 11172 
  38. demuxing and audio. 
  39.  
  40. * If you have a problem with Sparkle, first try to obtain the most recent 
  41. version. New versions are posted to the ftp site 
  42. sumex-aim.stanford.edu in the directory info-mac/grf/util. 
  43. I would suggest that you try a mirror of the sumex-aim site which is 
  44. constantly overloaded. Some suggestions are 
  45. ftp.hawaii.edu           128.171.44.70    mirrors/info-mac
  46. src.doc.ic.ac.uk         146.169.2.10     packages/info-mac            
  47. imftp.mgt.ncu.edu.tw     140.115.83.90    /pub/mac/info-mac            
  48. Sparkle does eventually drift to commercial providers like AOL and 
  49. Compuserve but I don't have accounts on those so they may ftp sites by a 
  50. month or more.
  51. New versions are released about every two or three months.
  52.  
  53. * If obtaining the most recent version does not solve your problem, feel 
  54. free to mail me. My address is 
  55. maynard@elwing.otago.ac.nz.
  56. I try to fix bugs the moment I learn of them. If you have a suggestion for 
  57. the future, not a bug report, I will add it as soon as I can. However many 
  58. suggestions I receive are things I already have planned that require 
  59. layers upon layers of support code to be written so they may not be 
  60. implemented for a while.
  61.  
  62. * I have in the past given the code to people who request it. However I'm 
  63. not making it generally available because it is, at any given stage, 
  64. riddled with junk from previous versions, along with hooks I've placed for 
  65. future ideas and it's a mess. It is cleaned up as I update it, but other 
  66. parts become a mess. 
  67. The code requires detailed knowledge of 
  68. MPEG
  69. QuickTime
  70. QuickDraw and the Mac OS (and 68K assembly)
  71. Threads and the Mac Thread Manager
  72. If you don't know much about any of these areas, trying to learn about 
  73. MPEG from this code will probably waste your time.
  74.  
  75. * The ``kernel'' of Sparkle is based on threads that communicate with each 
  76. other asynchronously. This design offers two important benefits.
  77. Firstly it is very easy to write UNIX style code that is 
  78. compute-intensive and runs for a long time, yet maintain interactivity with 
  79. the user and processing events.
  80. Secondly the asynch communication means it should be fairly easy to get 
  81. Sparkle to vector all MPEG encoding/decoding to dedicated hardware while 
  82. still using the Sparkle user-interface, time-slicing, memory-management and 
  83. scheduling.
  84.  
  85. * I maintain Sparkle as a hobby, and because of that things proceed 
  86. slowly---I can't devote more than a few hours a week to it.
  87.  
  88. * If someone wants to hire me to do this as a full time job, I'm eager for 
  89. any offers. Please mail me.
  90.  
  91. Maynard Handley
  92. 17 May 1994